home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / lmcolo.z / lmcolo
Encoding:
Text File  |  1998-10-20  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. llllmmmmccccoooolllloooo((((3333GGGG))))                                                          llllmmmmccccoooolllloooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      llllmmmmccccoooolllloooo - change the effect of color commands while lighting is active
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee llllmmmmccccoooolllloooo((((mmmmooooddddeeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 mmmmooooddddeeee
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _m_o_d_e   the name of the mode to be used.  Possible modes are:
  17.  
  18.             LLLLMMMMCCCCCCCCOOOOLLLL, RGB color commands will set the current color.  If a color
  19.             is the last thing sent before a vertex the vertex will be colored.
  20.             If a normal is the last thing sent before a vertex the vertex will
  21.             be lighted.  LLLLMMMMCCCCCCCCOOOOLLLL is the default mode.
  22.  
  23.             LLLLMMMMCCCCEEEEMMMMIIII, RGB color commands will set the EEEEMMMMIIIISSSSSSSSIIII color property of
  24.             the current material.
  25.  
  26.             LLLLMMMMCCCCAAAAMMMMBBBB, RGB color commands will set the AAAAMMMMBBBBIIIIEEEENNNN color property of
  27.             the current material.
  28.  
  29.             LLLLMMMMCCCCDDDDIIIIFFFF, RGB color commands will set the DDDDIIIIFFFFFFFFUUUUSSSS color property of
  30.             the current material.  Alpha, the fourth color component specified
  31.             by RGB color commands will set the AAAALLLLPPPPHHHHAAAA property of the current
  32.             material.
  33.  
  34.             LLLLMMMMCCCCSSSSPPPPEEEE, RGB color commands will set the SSSSPPPPEEEECCCCUUUULLLL color property of
  35.             the current material.
  36.  
  37.             LLLLMMMMCCCCAAAADDDD, RGB color commands will set the DDDDIIIIFFFFFFFFUUUUSSSS and AAAAMMMMBBBBIIIIEEEENNNN color
  38.             property of the current material.  Alpha, the fourth color
  39.             component specified by RGB color commands will set the AAAALLLLPPPPHHHHAAAA
  40.             property of the current material.
  41.  
  42.             LLLLMMMMCCCCNNNNUUUULLLL, RGB color commands will be ignored.
  43.  
  44. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.      Properties of the currently bound material can be changed by calls to
  46.      llllmmmmddddeeeeffff.  Because the data structure of the material must be modified by
  47.      this operation, however, it is relatively slow to execute.  llllmmmmccccoooolllloooo is
  48.      provided to support fast and efficient changes to the current material as
  49.      maintained in the graphics hardware, without changing the definition of
  50.      the currently bound material.  Thus llllmmmmccccoooolllloooo changes are lost whenever a
  51.      new material is bound.
  52.  
  53.      The standard RGB color commands (RRRRGGGGBBBBccccoooollll, cccc, and ccccppppaaaacccckkkk) are used to change
  54.      material properties efficiently.  llllmmmmccccoooolllloooo specifies which material
  55.      property is to be affected by these commands.  While lighting is not
  56.      active color commands change the current color.  llllmmmmccccoooolllloooo mode is
  57.      significant only while lighting is on.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. llllmmmmccccoooolllloooo((((3333GGGG))))                                                          llllmmmmccccoooolllloooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      lmdef, lmbind, RGBcol, c, cpack
  76.  
  77. NNNNOOOOTTTTEEEE
  78.      llllmmmmccccoooolllloooo allows changes only to the properties of MMMMAAAATTTTEEEERRRRIIII, not to the
  79.      properties of BBBBAAAACCCCKKKKMMMMAAAA.
  80.  
  81.      While llllmmmmccccoooolllloooo is other than LLLLMMMMCCCCNNNNUUUULLLL or LLLLMMMMCCCCCCCCOOOOLLLL, and lighting is active, the
  82.      results of lighting are undefined between the time that a material is
  83.      bound and an RGB color command is issued.
  84.  
  85.      While llllmmmmccccoooolllloooo is other than LLLLMMMMCCCCNNNNUUUULLLL or LLLLMMMMCCCCCCCCOOOOLLLL, and lighting is active, the
  86.      results of lighting are undefined if an RGB color command is specified
  87.      between an nnnn command and the subsequent vvvv command.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.